{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# User's Guide, Chapter 15: Keys and KeySignatures\n",
    "\n",
    "Music21 has two main objects for working with keys: the :class:`~music21.key.KeySignature` object, which handles the spelling of key signatures and the :class:`~music21.key.Key` object which does everything a KeySignature object does but also knows more advanced aspects of tonal harmony.  We'll go through the basics of each one here.\n",
    "\n",
    "We start, like always, by importing music21:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "from music21 import *"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now let's get a couple of different key signatures, representing different numbers of sharps:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "2"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2 = key.KeySignature(2)\n",
    "ks2.sharps"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.KeySignature of 7 sharps>"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks7 = key.KeySignature(7)\n",
    "ks7"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can get a list of which pitches (as :class:`~music21.pitch.Pitch` objects) are altered by the key signature with the `.alteredPitches` property:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<music21.pitch.Pitch F#>, <music21.pitch.Pitch C#>]"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2.alteredPitches"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There's also a method that lets us see what the accidental is for any given step:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<accidental sharp>"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2.accidentalByStep('C')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "True"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2.accidentalByStep('E') is None"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Notice that we give a string of just a letter name from C-B.  This won't work:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [],
   "source": [
    "ks2.accidentalByStep('C#')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can create key signatures with absurd numbers of sharps and get strange accidentals:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<accidental double-sharp>"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks12 = key.KeySignature(12)\n",
    "ks12.accidentalByStep('F')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "These absurd key signatures display in some programs (such as Lilypond) and are exported into MusicXML but do not display in most MusicXML readers.\n",
    "\n",
    "Key Signatures transpose like Pitches and Notes, taking each of the notes and moving it:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.KeySignature of 4 sharps>"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks4 = ks2.transpose('M2')\n",
    "ks4"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And the number of sharps can be changed after the fact:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.KeySignature of no sharps or flats>"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks4.sharps = 0\n",
    "ks4"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can get the Major or Minor scale corresponding to the Key Signature:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.scale.MajorScale D major>"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2.getScale('major')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.scale.MinorScale B minor>"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ks2.getScale('minor')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We'll see what we can do with scales in a bit.\n",
    "\n",
    "If we put a KeySignature into a Stream, we can see it:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 56,
       "width": 248
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "m = stream.Measure()\n",
    "m.insert(0, meter.TimeSignature('3/4'))\n",
    "m.insert(0, ks2)\n",
    "d = note.Note('D')\n",
    "c = note.Note('C')\n",
    "fis = note.Note('F#') # German name\n",
    "m.append([d, c, fis])\n",
    "m.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note that the Note 'C' is treated as C-natural and thus needs the natural sign in front of it.  The Note F# however does not need a natural sign to be displayed.  The process of calling `.show()` on the stream made a copy of the notes and set the `.pitch.accidental.displayStatus` on the F# to `False` and created an accidental for the C note with a natural and a displayStatus of True. Then the copies were discarded, so we don't see them here:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [],
   "source": [
    "fis.pitch.accidental.displayStatus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "But we could instead call `.makeNotation(inPlace=True)` or `.makeAccidentals(inPlace=True)` on the Measure to do this manually: "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "False"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "m.makeAccidentals(inPlace=True)\n",
    "fis.pitch.accidental.displayStatus"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(<accidental natural>, True)"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "c.pitch.accidental, c.pitch.accidental.displayStatus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we have a `Measure` (not just any `Stream`) we can also set the KeySignature for the beginning of the measure with the Measure object's `.keySignature` property:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 58,
       "width": 288
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "m.keySignature = key.KeySignature(4)\n",
    "m.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Of course life isn't all about sharps; it'd be a pretty terrible KeySignature object if we couldn't have flats.  To do it, just specify the number of flats as a negative number.  So -1 = one flat, -2 = two flats.  Or if you have the number as a positive already, just multiply by -1."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.KeySignature of 3 flats>"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "eroicaFlats = 3\n",
    "ksEroica = key.KeySignature(-1 * eroicaFlats)\n",
    "ksEroica"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "-3"
      ]
     },
     "execution_count": 19,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "ksEroica.sharps"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There is no `.flats` routine:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "tags": [
     "nbval-raises-exception",
     "raises-exception"
    ]
   },
   "outputs": [
    {
     "ename": "AttributeError",
     "evalue": "'KeySignature' object has no attribute 'flats'",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mAttributeError\u001b[0m                            Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-20-f5b0e75c7e79>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[0;32m----> 1\u001b[0;31m \u001b[0mksEroica\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mflats\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
      "\u001b[0;31mAttributeError\u001b[0m: 'KeySignature' object has no attribute 'flats'"
     ]
    }
   ],
   "source": [
    "ksEroica.flats"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Example: Adjusting notes to fit the Key Signature\n",
    "\n",
    "Here's a nice study, suppose you had a score like this:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 53,
       "width": 380
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "m1 = stream.Measure()\n",
    "m1.timeSignature = meter.TimeSignature('2/4')\n",
    "m1.keySignature = key.KeySignature(-5)\n",
    "m1.append([note.Note('D'), note.Note('A')]) \n",
    "m2 = stream.Measure()\n",
    "m2.append([note.Note('B-'), note.Note('G#')])\n",
    "p = stream.Part()\n",
    "p.append([m1, m2])\n",
    "p.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's pretend that this was played by a young oboe player who was having trouble with the strange key signature. She got the B-flat right, and remembered to play some accidental on the G, but didn't do very well overall.  Let's fix these notes so that they fit with the key signature.\n",
    "\n",
    "Now we could simply do something like this for each note:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [],
   "source": [
    "m1.notes[0].pitch.accidental = pitch.Accidental('flat')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "But that wouldn't be as great as getting the notes from the Key itself.  Let's do that with the accidentalByStep routine:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 326
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "ks = m1.keySignature\n",
    "for n in p.recurse().notes:  # we need to recurse because the notes are in measures...\n",
    "    nStep = n.pitch.step\n",
    "    rightAccidental = ks.accidentalByStep(nStep)\n",
    "    n.pitch.accidental = rightAccidental\n",
    "p.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Yep, now our student is ready to play the concert!  Though wouldn't this be an easier key?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 288
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "p.transpose(1).show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Key objects\n",
    "\n",
    "A Key is a lot like a KeySignature, but much more powerful.  Unlike a KeySignature, which we initialize with the number of sharps and flats, we initialize a Key with a tonic string or Pitch:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of D major>"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kD = key.Key('D')\n",
    "kD"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of B- major>"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "bFlat = pitch.Pitch('B-')\n",
    "kBflat = key.Key(bFlat)\n",
    "kBflat"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "By default, keys are major, but we can make minor keys by specifying 'minor' as the second argument:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of d minor>"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kd = key.Key('D', 'minor')\n",
    "kd"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note that the key is represented as lowercase ('d minor' as opposed to 'D minor').  This is a clue as to a shortcut for making minor keys:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of g minor>"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg = key.Key('g')\n",
    "kg"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can also take KeySignatures and turn them into Keys by using the `asKey(mode)` method on them:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(<music21.key.Key of E- major>, <music21.key.Key of c minor>)"
      ]
     },
     "execution_count": 29,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "(ksEroica.asKey('major'), ksEroica.asKey('minor'))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "(In the latter case we should probably have called the variable ksFifthSymphony...)\n",
    "\n",
    "We can also make church modes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of A mixolydian>"
      ]
     },
     "execution_count": 30,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "amixy = key.Key('a', 'mixolydian')\n",
    "amixy"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you've forgotten how many sharps or flats are in the key of A mixolydian, you'll be happy to know that all the properties and methods of KeySignatures are also available to Keys:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "2"
      ]
     },
     "execution_count": 31,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "amixy.sharps"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<music21.pitch.Pitch F#>, <music21.pitch.Pitch C#>]"
      ]
     },
     "execution_count": 32,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "amixy.alteredPitches"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of C# mixolydian>"
      ]
     },
     "execution_count": 33,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "amixy.transpose('M3')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<music21.pitch.Pitch B->,\n",
       " <music21.pitch.Pitch E->,\n",
       " <music21.pitch.Pitch A->,\n",
       " <music21.pitch.Pitch D->,\n",
       " <music21.pitch.Pitch G->,\n",
       " <music21.pitch.Pitch C->,\n",
       " <music21.pitch.Pitch F->,\n",
       " <music21.pitch.Pitch B-->,\n",
       " <music21.pitch.Pitch E-->,\n",
       " <music21.pitch.Pitch A-->,\n",
       " <music21.pitch.Pitch D-->,\n",
       " <music21.pitch.Pitch G-->,\n",
       " <music21.pitch.Pitch C-->,\n",
       " <music21.pitch.Pitch F-->]"
      ]
     },
     "execution_count": 34,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "aDarkKey = key.Key('B--', 'locrian')\n",
    "aDarkKey.alteredPitches"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "(as a music historian and someone who specializes in history of music theory, I am contractually obliged to mention that \"locrian\" is not a historic mode and doesn't really exist in actual music before the 20th c.  But it's fun to play with).\n",
    "\n",
    "Keys know their `.mode`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "('minor', 'mixolydian')"
      ]
     },
     "execution_count": 35,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.mode, amixy.mode"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "They also know their tonic pitches:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(<music21.pitch.Pitch G>, <music21.pitch.Pitch A>)"
      ]
     },
     "execution_count": 36,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.tonic, amixy.tonic"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For major and minor keys, we can get the relative (minor or major) and parallel (minor or major) keys simply:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of B- major>"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.relative"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of G major>"
      ]
     },
     "execution_count": 38,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.parallel"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And because two keys are equal if their modes and tonics are the same, this is true:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "True"
      ]
     },
     "execution_count": 39,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.relative.relative == kg"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is pretty helpful from time to time:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'g'"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.tonicPitchNameWithCase"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'G'"
      ]
     },
     "execution_count": 41,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kg.parallel.tonicPitchNameWithCase"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Some analysis routines produce keys:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of f# minor>"
      ]
     },
     "execution_count": 42,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "bach = corpus.parse('bwv66.6')\n",
    "bach.analyze('key')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The keys from these routines have two extra cool features.  They have a certainty measure:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.9379555412471554"
      ]
     },
     "execution_count": 43,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fis = bach.analyze('key')\n",
    "fis.correlationCoefficient"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "1.2642604260880534"
      ]
     },
     "execution_count": 44,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fis.tonalCertainty()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here are some of the other keys that the Bach piece could have been in:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<music21.key.Key of A major>,\n",
       " <music21.key.Key of b minor>,\n",
       " <music21.key.Key of E major>,\n",
       " <music21.key.Key of c# minor>]"
      ]
     },
     "execution_count": 45,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fis.alternateInterpretations[0:4]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And the least likely:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<music21.key.Key of B- major>,\n",
       " <music21.key.Key of E- major>,\n",
       " <music21.key.Key of c minor>]"
      ]
     },
     "execution_count": 46,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fis.alternateInterpretations[-3:]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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JEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEnSEBjpdwUkSZrCtgb2AnYENgfmADOAR4GHgLuBW4DrgZV9qqMkddNJwEbA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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 296,
       "width": 750
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "c = bach.measures(1, 4).chordify()\n",
    "for ch in c.recurse().getElementsByClass('Chord'):\n",
    "    ch.closedPosition(inPlace=True, forceOctave=4)\n",
    "c.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Yeah, that passes the smell test to me!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "So, how does it know what the key is?  The key analysis routines are a variation of the famous (well at least in the small world of computational music theory) algorithm developed by Carol Krumhansl and Mark A. Schmuckler called probe-tone key finding.  The distribution of pitches used in the piece are compared to sample distributions of pitches for major and minor keys and the closest matches are reported.  (see http://rnhart.net/articles/key-finding/ for more details).  `Music21` can be asked to use the sample distributions of several authors, including Krumhansl and Schmuckler's original weights:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.key.Key of f# minor>"
      ]
     },
     "execution_count": 48,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "bach.analyze('key.krumhanslschmuckler')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Though the `key` returned by `.analyze('key')` and `.analyze('key.krumhanslschmuckler')` are the same, the correlationCoefficient is somewhat different. `fis` is the analysis from `.analyze('key')`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(0.938, 0.815)"
      ]
     },
     "execution_count": 49,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fisNew = bach.analyze('key.krumhanslschmuckler')\n",
    "fisCC = round(fis.correlationCoefficient, 3)\n",
    "fisNewCC = round(fisNew.correlationCoefficient, 3)\n",
    "(fisCC, fisNewCC)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Calling `.analyze()` on a Stream calls :func:`music21.analysis.discrete.analyzeStream` which then calls an appropriate Class there.\n",
    "\n",
    "There is another way of looking at the key of a piece and that is looking at differently sized windows of analysis on the piece and seeing what happens every quarter note, every half note, every measure, every two measures, etc. to the top.  This plot was created by Jared Sadoian and is explained in the `analysis.windowed` module:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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ffs032vFihWTpHRvSQTgvQg+ANz2KlWqJOlaeDFz5swstVG3bt0Uw+644w4VKlTohmpzx/FEhOSKFi2a6jjHH2zHjh1Ls91KlSq57bwzNDRUklweQ+nQvn17l3uok3P8Eblnz540l1uzZk23T6hIbbkVK1aUdK1vgKlTp6b4w/ejjz5Sx44d01xmVnTp0kUHDx7UlClT1KRJE2eAcenSJX399dd64okn1KhRI506dcplvm+//dbZr0Jq9823bNlSy5cvV/Hixd2Oz8q+SS6tY6ZSpUopQpFcuXI5Q570jpvM2Lhxo7NWRyB3vTp16mj58uW655570mxr6tSp6tq1qz7//HM9//zzWarHsW8CAgJ0//33u52mSpUqkq71t5PaE0jcvf/z58+vUqVKZakuxzH+66+/qnHjxjp37ly688THxzv7oHn44YfdTuNYl6SkJK1bt845PHfu3Oratask91/kJ0+erIiIiBShXUYYYzRr1iw1bdpURYoUcQ7PmzevM0jZunWrfv3113TbstlsKYb5+/s7j1V374NXXnkl1b5WMnqOcsfx5XvJkiUplhsZGSmbzZYihHbs1969e6cIdMPCwrRs2TLn+Tojsru9M2fOSFKmwhIpa5+hCxculHQtrE7tfeI4Xq/vU6Zjx47Kly+f/v77by1evNhl3Ndff624uDhFRES4DHdsq1GjRmnRokVKSkpyGf/VV1+lek6Srv3AIP3/NgJw6yH4AHDb+/HHH1W+fHkZY9S1a1fNmzcv021kpBO37FK4cOEUwxwdBbob57gaIyEhIc12k38pSc7Rs398fHyKccYYzZ07V02bNlVoaKgCAwPl6+srX19f5x+RcXFxaS7XXc1pLffFF19UjRo1FB8fr27duqlEiRLOzunSW8cblTdvXnXt2lXff/+9Tp48qfnz56tNmzbObbxq1So988wzLvPs3r1bklSoUKFUg7B8+fLp8ccfd/5xfb2s7JvkMnvMSP9/3KTXdmY4toWkVL+M5sqVS48//niqdUnXvpx3795dSUlJNxTM2O12SdfWMW/evM5jN/m/AQMGSLoWcF0fajlk9/u/U6dOGj58uCRp27ZteuKJJ9J9H+3du9e5r7p27ep2XRxhlyT9+eefLvN369ZNuXLl0u7du12uDlu7dq327NmT4uqFjIqKitKhQ4ecV84kl3xYWp2cOmT2XCFJFy9e1KhRoxQeHq6QkBD5+/s7t8fbb78tKf1zlDv169dXpUqVdPXqVU2dOtU5PC4uTnPmzHG7vcaMGaO8efNq+/btstlsqlGjhoYOHapdu3Zlevk3oz1Hp9CZudpDytpnqOO9d+DAAbfHqq+vrz7++GNJKY/VoKAg53n2+qBu0qRJat26dYpz5qBBg1S2bFmdPn1arVu3VpkyZfTSSy/phx9+SBGCuOMI/bKz42wAOYvgA8Btr3Tp0lq9erVKly6txMREde7cWUuXLs1UG44vkTkhrUuJs3qrTlbmNcbo6aefVocOHfTf//5XQ4YM0erVq7Vjxw7t2LFDkydPdk6Xlsxuu/z58+vnn3/W2LFjVaVKFZ06dUrTpk3TU089pdKlS2v06NHpLjM7BAUFqW3btlqwYIH27t2re++9V9K18MPxR70k51MAUgs1MuJG9mt6899o25mR/IkIWd0e27dvV79+/ZxXC7z99tuZegqMu3pCQkKcx+31/3bu3Cm73S673Z7qF++b8f4fPHiwhgwZIunarUwtWrRwPrkprXWRpE8//TTV9XGsy/VXyZQpU0ZNmjSR5PplMjIyUvXq1cvy7WMzZsxQoUKF1KJFixTjGjZs6Lxq6csvv0z1KU4Omd3OJ0+eVK1atfTKK69IurZdNm3a5NwWL774oqT0z1Hu+Pj4OG8Rmzx5srONuXPnyhjj9qqzJk2aaPv27erRo4eCgoK0a9cuvf3226pRo4YeeOABbdmyJVM1ZHd7AQEBkpTqlU2pycpnqON4veeee1I9Vnft2iW73a5ffvklxfyOYGnVqlWKjY2VJP3+++9as2aN29CpVKlS2rFjh4YNG6bSpUvryJEjmjBhgho3bqywsLB0b7dybBPHNgJw6yH4AABd+/V59erVCg0N1ZUrV9SuXTutXLkyx5af3h/83ujrr7/W/Pnz5efnp5UrV6pXr16qW7euqlevrurVq6t8+fI3bdmBgYHq37+/fvvtN23fvl2vvfaaQkNDdfz4cQ0cOND5K312OXnyZJpXPpQvX16fffaZ8/V///tf5/8XKFBAktL80mo1qR3Pjm0hZX17XLp0SfPnz9fcuXNVq1YtJSQkKCIiItVHUaYl+b5xHLdp/cvsL+E36u2333Z+aV+zZo1atWqV6lVNybdtkSJF0l0Xd7dAOL4wzps3T+fOndOZM2e0cOHCLF/tERcXp4ULF+rs2bPKly9fil/0/f39nVfsHDt2TCtWrMjSclLz1ltvKSYmRpUrV9bq1avVvn171apVK81tkBldunSRn5+fYmNj9cMPP0i6FhR16NAhxe1jDpUrV9akSZN0/PhxLVq0SO3bt5efn582b96shx56KMUtK+nJzvYct9Nl5SqvzH6GOo7XxMTEDL33rnf//ferRo0aMsYoMjJS0rUAqnLlyqneflmoUCENHTpUBw8e1MaNG9W3b18FBwfr4MGD6tKli/MKE3cc28TdLYcAbg0EHwDwPxUrVtTq1atVvHhxxcfH66mnnnK5D/5GOS6VdffF5eTJk9m2nJziuO+6cuXK2d6ZaGbce++9GjlypPbv368OHTpIkj7++OMsfRFOTdGiRTVlypQ0p6lRo4bz/5N/Qb777rslSWfPntXZs2fdzpuUlKS4uLibfqtOdknrWJZSP54d20KS81fa6xljFBcXl+qXr7p166p58+by9fXVzJkzFRgYqJ07dzpvW8gMRz0XLlzQ0aNHU53u66+/1uzZszPdfnZ4//331a9fP0nSihUr9PTTT7v9Rb5SpUrOX6P37t2banu7d+/W5MmTXTo3dWjevLlCQ0OdnZzOnDlT+fLlU5s2bbJU+4IFC3ThwgUtX7481V/1V61a5ezjJ6OdnGaU4xzVqFGjm/JLfbFixfTUU09JunaVzK5du7Rly5YMBUWBgYF66qmn9NVXX2n37t264447dOXKlTS/fN/s9sqWLSvp2rkqI7d/XC8zn6GO997+/fvTvMJk5syZWrJkidtxyTs5vXjxoqZPn56iU1N3fHx8VLduXY0fP14HDhxwBiVjx45NdR7HOS21W/QAeD+CDwBIpkqVKlq1apVCQkJ06dIlNW/eXJs3b86Wth0dV7rrgG/r1q3Zsoyc5Li0O7XLxA8dOnRTltuvXz8999xzKYYHBATo1VdflSRduXJFp0+fztblprePkn9xTv4LZbNmzZy3daxevdrtvFOmTFFQUJCWLVuWDZXefGkdy2fPntW+ffvczle3bl3nrQ2pbYtVq1YpKChIEyZMSLeOqlWr6r333pMkvffee5l+HyXfN999953baU6cOKGnn35a8+fPz1Tb2enDDz9Ur169JEnffPONnn322RRfTAMDA523k6S2LtK1W2h69+7t7BcjOV9fX+ctMJ9//rmzU9OshgYzZsxQeHi4Hn/88VR/yW/QoIGzP6DFixenGg5mRU6coxxfvhcvXqx33nlHNWvWVK1atdxOe8cddzg7oE2ucuXKzj4r0uuo+Ga2V61aNUnXrsLIzHzJZfQztG3btpKuXW11feelDtu3b1dERISioqLcju/cubPy5s2rv/76S927d9fZs2edTxO7XuvWrTV48OAUwwsUKOB86k9a63zkyBFJ1845AG5NBB8AcJ3q1avrhx9+UHBwsM6fP6/HH39c27dvv+F2H3zwQUlK8QtYQkKC81LdW0l4eLika09E2LFjh8u4pKQkt0+HyA7nzp3Td9995/aqAscv3WXKlLnhy9ivN2fOnFT7kjDGaNiwYZKuPSY2+RUwRYsWdd6uMHLkyBRXSVy8eFHjx49XyZIl3faD4I0cx3J0dHSKzv4mTJiQ6hdNf39/jRgxQpI0fvz4FF9yk5KS9P777ytfvnx69tlnM1RL37591aBBA129elURERGZukw/+b5599133X7pfuWVV5SYmOh8FKynTJgwwfnklblz56pbt24ptvNbb72lPHnyaOPGjW5/JV+9erW+/fZbde3aNdUOWbt37+7s5HT37t1Zvs3l4MGDWrt2bYZ+gXcsIz4+XnPnzs3S8txxnKOWLVuWogPTv/76K8UTQbKiYcOGqlChgq5evaoFCxakub3+/vvvVAM0x7krtdAkJ9orV66c84qGmJiYDM93vYx8hlavXt355JUhQ4akOC8mJSVp4MCBypMnT6qP+y5QoIDzEclz5sxR69atUz2uT58+rYULFzqfsJVcetvq8uXLzivUHI8BB3Dr8fV0AQCQk44cOaIzZ844f72R/v9JE+XLl1e+fPkkXbt9YuXKlXrsscd09uxZNW7cWPPmzVPRokUVGhqa4rL4vXv3Ki4uTsHBwSpZsqTbZffu3VsTJ07UtGnTVKJECeeTGkaNGqV27do5v1Q76qlWrZoSExO1Z88el+Xt3r1b/v7+qly5so4fP67jx487v7AdP35cu3fvVqlSpVSoUCHt3r07xbzStT86z549q8OHDzu3xYULF7R7927nOqTWdrFixVSsWDG1b99en332mdatW6fHH39cQ4YMkc1m04kTJzRu3DjnkwWuXLnitubjx49LunaFQPJ2HfvowoULzn2WfJ18fHx06tQp1a9fX//5z39UtWpVJSYmavPmzRoxYoT8/f01ceJE5+Xze/fuVUJCQqrtZYSvr68uX76s8PBw9e7dWw0bNlTx4sV15swZ/f777/rss8+0fft2VatWTbNmzUox/5AhQ3TgwAHNmDFDDRs21IABA1SyZEn98ccf+uCDDxQbG6s1a9Y4b5G50X3jWGfH7T6xsbEKCQlRlSpVlJCQoNjY2FTbjo2N1YULF1LMm/z9Ua1aNTVr1kzffvutmjVrpoEDB6po0aJaunSptm3bpvDwcK1bt865rUNDQ50dg3bp0kV//PGHhg8frocffliDBw9WpUqV9Oeff+rjjz/WmiExlIcAACAASURBVDVrtGjRIucTSNLbFkePHtWAAQO0fv16/fe//9XAgQPVs2dPFStWTGfPnk133yffN3Xr1tXrr7+uqlWr6ujRo4qMjNTSpUv13nvvuTyy1nGMXr/9He+tzLhy5YrzcaqObe5oL1++fM6+cnx8fBQZGamEhAR98cUXmj59ugIDA9WnTx/5+vrqzjvvVLVq1fTVV1/pmWee0dNPP62BAwfqiSee0JUrVxQVFaVRo0bJZrNp1KhRqdZTrlw5NWrUSCtWrNAjjzzifKRoZtdn+vTp8vf3V7Vq1RQbG5tqnz+xsbGqWLGi8ufPr7i4OE2ZMkUPPfSQgoODJcntdnbsv/SO1TfeeENLlizRoUOH9Mgjj2jQoEEqV66cfvvtNw0bNsw5n+Mc5DimHPsyrfeAg6OT09dee0358+dP91HaM2bMUGJiop555hmVKFFCJ06c0Jw5c/Tdd9/prrvucvZPlPy4cHB8zlSpUsV5rshoexnVunVrjR07Vhs2bHD7eNfs+gwtXLiwPv30U/31119asWKF6tWrpwEDBqhcuXKKjY3Vhx9+qJ9//lkzZsxIs7+onj17atq0ac7/T42Pj4/27NmjBg0aqG/fvqpQoYIuXryotWvX6t1331XBggX14Ycfup1348aNSkpKUq1atVSmTJn0NyIA72QA4DYSERFhJLn9FxUVlWL6TZs2mfz587tM9/HHH6faRkRERJrL37p1q2ncuLEJCgoy+fLlM+Hh4Wb58uUmNjY2RVvnz593O1ySKVu2rDHGmKFDh7odP23aNGOMSbVOY4yZNm1amuuQWttDhw51rs+lS5fMW2+9ZapWrWr8/f1Nnjx5TPXq1c3QoUPN0qVLM1Wzo93U9pFjnf755x8zadIk07JlS1OmTBnj7+9v/P39Tbly5UxERISx2+0u27xs2bJptpcRp06dMjNnzjRdu3Y1NWvWNEWKFDG+vr7G39/flChRwjRp0sR89tln5vLly2m2880335jHH3/cOX+JEiVMx44dza+//uoy3Y3um9TWOTY21kRFRaXZdr169TL0/jh//rzp27evKVmypPHz8zPly5c3b775pomPj0/Rxscff5xiW6xdu9a0bt3aFC9e3Pj6+pqQkBDz5JNPmk2bNmVqW6R2vAwdOjRT+96xb0JCQoyvr68pWrSoadmypfnxxx9TTJvWeSSzUnuPSzL16tVLMf3Vq1dN+/btXaYrUqSIyzT79+83L774ogkLCzMBAQEmX758xmazmdGjR5v4+Ph0a5o/f76RZL744otsWR936+GQ2vEWERGR7rkgI8fq4cOHTY8ePUypUqWMr6+vKViwoHnooYfM1KlTzZtvvun2mEptf7j7jDDGmL/++svkzp3bdO/ePc1tExMTYwYPHmwefPBBU7hwYZM7d26TP39+Y7PZzIgRI0xcXFya2zH5+ziz7WXUH3/8YXx9fU21atXcjs+uz1CHxMREM336dFO/fn1TqFAh4+vra0JDQ80zzzxjoqOjM1TzXXfdZSpVqpTmNMePHzfjxo0zjRs3NiVKlDB+fn4mICDAVK5c2fTp08ccOHAg1Xl79uxpJJmZM2dmqB4A3snHmBx45h8AAABuCRMmTNCbb76po0eP8vjODPj1119VvXp1bdmyRbVr1/Z0OTds4MCBGj16tBYsWJDljm1zytWrV1WmTBn179//ptyOdvDgQVWtWlV33323fvrppxx9/DeA7EXwAQAAAKeaNWuqXr16GjdunKdLuSX8+9//VlRUVLb0BeUNLl++rEaNGmnv3r3avHmzVz/JZMmSJWrXrp0OHz7svD0uu8THx+uxxx7T3r179dNPPyksLCxb2weQs4gtAQAAblPLly93Pg1JkjZt2qSdO3fqxRdf9GBV3uvw4cNq2bKl8xGsFy5c0PTp09W7d28PV5Z9AgMDtWzZMtlsNj300EM37QldWfHss8+6dDL9ySefqG3bttkeekjSY489pmPHjmn16tWEHoAF0LkpAADAbergwYP68MMPVbt2bRUtWlQvvfSSOnbsmOlOTW8XcXFxWrp0qYYPH66mTZtq9OjRCg4O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ABCRo+AjSZK44447Ytq0afHAAw9Eu3btyt5r2LBhTJs2LZYtWxaNGjXKqva9994bSZJscl7NmjWjWbNm0aFDh6hRo0al1wEAAADSJ2dnfFx00UVx++23xxFHHBE33XRTXHzxxeXez2Qykclksqrdp0+fzc5JkiQymUzstttuMXr06Dj11FOzWgsAAABIj5wEH5lMJn71q1/FiSeeGH369InLLrssnnvuuRg/fnzsscceW1V73Lhxccstt8Tq1avjtNNOi+bNm8fOO+8cK1eujIULF8bDDz8cbdq0iTPOOCMWL14cTz/9dPTq1SuaNGlS6fNEAAAAgHTJ6VNdunbtGn/5y1/i3HPPjSeeeCIOPvjgGDt2bPTs2TPrmsuXL4/27dvHuHHjoqioaKP3R4wYEeeee27UqVMnBg0aFIMGDYoBAwbEiBEjBB8AAACwg9s4SdhKjRo1GC0gIwAAIABJREFUit///vdx1113xRdffBE/+tGPYsCAAbFq1aqs6o0ZMyZuuummCkOPiIiioqK48cYbyz1mduDAgTFjxoys1gMAAADSI+fBx1f69+8fs2bNisMOOyzuvvvuOProo7OqM3/+/GjYsOEm5zRq1Cjmzp1b9rpFixZZBy0AAABAeuQk+EiSJPr27RsXXnhhufF99tknXnvttbjiiiti0aJFWdWuX79+PPzww5uc89BDD0X9+vXLXi9evDgaN26c1XoAAABAeuTkjI/x48dHxH8eKbvRAtWrx/Dhw+PEE0+M22+/vdK1f/SjH0X//v3j73//e5x++umx7777RrVq1WL9+vUxd+7c+L//+78YOXJknHfeeRERUVpaGkOGDIl99tln6z4UAAAAsN3LSfDRu3fvzc459thjszps9MYbb4xXXnklhg0bFjfccENERNSoUSPWrVsXEf/ZbXLooYfGjTfeGBERRx11VMycOTNGjRpV6bUAAACAdNlmZ3xUpFq1apW+pkGDBjFjxowYPHhwtGrVKpIkiS+//DKSJInvfOc7MWzYsHjllVeiXr16ERHx+OOPx/z582PAgAG5bh8AAADYzmS14+OTTz6JVatWRfPmzSMi4g9/+MMWXZckSTbLRa1atWLw4MExePDgWLlyZaxYsSLq168fdevW3Whu06ZNs1oDAAAASJ+sgo/DDz88/v3vf8c///nPaNCgQXTq1Ckymcxmr9uSOZuz8847x84777zR+O9+97s4++yzt7o+AAAAkB5ZBR/77bdfLFiwIGrXrl02NmjQoE1ekyRJDBs2LJvltsg555wj+AAAAADKySr4eOaZZzYaGzx48GavGzp0aDbLxaxZs+L++++P999/P1avXp31LTMAAADAjiUnT3WZNm1aTud93YMPPhhnnXVWbNiwYZPzcnEbDQAAAJAuOXmqS8eOHXM67+uGDBkSxx57bLz++uuxYsWK2LBhQ4U/7AIBAAAAviknOz4qMnXq1Hj77bejuLg4jj/++Nhvv/2yqjN//vx47rnnokWLFpuc17t376zqAwAAAOmVVfDx5ptvxqWXXhoREY0aNYpHHnmk7L01a9ZEjx494oUXXigby2Qy8V//9V8xfPjwSq+15557VvgUl28aP358pWsDAAAA6ZbVrS6TJ0+O6dOnx2effRZHH310ufduuOGGmDp1amQymTjttNPi4osvjgMPPDBGjBgRzz77bKXXuuCCC2Ls2LGbnde6detK1wYAAADSLasdH6+88kp07949Hnvssahe/f8v8eWXX8add94ZmUwm7rrrrjjvvPMiIqK0tDROPvnkGDt2bHzve9+r1FqHHXZYjBgxIl577bXo2bNnNG3atNxjdL+ycOHCbD4KAAAAkGJZBR/vv/9+jB8/vlzoERExZcqUWL58eTRt2jT69u1bNl6tWrW4+uqro1evXpVe6/jjj49MJhNJksRTTz2VTbsAAADADiqr4GPJkiXRtm3bjcaffvrpyGQy8aMf/SiKisrfRdOuXbv46KOPsmpy0KBBm3w/SZIYNmxYVrUBAACA9Moq+Pjiiy822u0RETFp0qSIiDj55JM3eq9GjRpRs2bNbJaLwYMHb3bO0KFDs6oNAAAApFdWh5s2bdo0/va3v5Ube/HFF2PRokVRv379OO644za6ZsGCBbHHHntUeq3XXntti+bNnz+/0rUBAACAdMsq+Dj22GPjmmuuiTVr1kRExLJly+KKK66ITCYTZ5xxRoW7Qe6+++5o2bJlpdfq0KHDFs1r0aJFpWsDAAAA6ZZV8DFw4MD4wx/+EM2aNYsOHTpEq1atYtasWVG3bt246qqryuatXbs2Xn755bjoooti9OjRFe4E2VIvvPBC/PSnP4399tsvdtlll4iIeOONN+KGG26IlStXZl0XAAAASK+szvho165dPP7443H++efHn/70p8hkMnH44YfH6NGjY6+99iqbN2PGjHJhR7du3Sq9VpIkMWDAgLjnnnsiSZKIiMhkMhERUatWrbjzzjvj8ccfjxdeeCHq16+fzccBAAAAUiqrHR8RESeeeGLMmzcv/vWvf8Xnn38eb7zxxka3pXTs2DE2bNhQ9uPQQw+t9Dp33XVXjBs3Ls4666x4+umn46233ip776CDDoq///3vUbdu3bjtttuy/SgAAABASmUdfHxlt912i9q1a+eilwrdfffdMWrUqJg4cWJ873vfiwMPPLDc+zvttFPceuut8cgjj2yzHgAAAIDtU1a3uuTT3Llz45xzztnknHbt2sXChQvz1FHllZSUVDg+Z86cPHcCAAAAO5at3vGxrVWrVi1Wr169yTkLFy6MGjVq5KkjAAAAYHtR5Xd8lJSUxNVXXx1jxowpO9T0m26++eY44ogj8tzZlps1a1aF4yUlJTF79uw8dwMAAAA7jioffAwcODC6d+8e06dPjz59+sTBBx8cERHTpk2L+fPnx8SJE+Pll1+O559/vsCdAgAAAFVNlQ8+TjrppLjlllviyiuvjEGDBpWNd+7cOSIiioqK4le/+lXZawAAAICvVPngI+I/uz66dOkSv/3tb+NPf/pTLF++PBo0aBAdOnSIAQMGRLt27QrdIgAAAFAF5ST46Nu3b4wbNy4Xpb7VwQcfHL/5zW+26RoAAABAuuQk+JgwYUKcfPLJ0a1bt6hTp04uSm6Rm2++Od57772IiMhkMnHPPffkbW0AAACg6svZ42xHjhwZjRs3ju7du8fYsWNj6dKluSr9rZIkiSRJYu3atTFhwoRtvh4AAACwfcnZGR+vvvpqLF26NCZNmhRPPPFEXHzxxXHggQdGz549o2fPnrH//vvnaqkyV111VURELFu2LB588MGc1wcAAAC2bznZ8TF//vyIiNh9993jvPPOi6eeeio+/vjjuOKKK+K9996Ljh07Rps2bWLgwIG5WG4jmUxmm9QFAAAAtm85CT5atGix0diKFSvi448/jo8++ihWrlwZ//jHP+K2227LxXIAAAAAWySnj7P929/+Fk888UQ88cQTMXPmzLIzONq2bRs9evSIHj165HI5AAAAgE3KSfBx2WWXxZNPPhnz5s2LJEmiWrVq8d3vfrcs7Nh77723uFY+Ho0LAAAA7BhyEnyMHTs2Pv/88yguLo4rr7wyLrroomjQoEFWtSZOnCj4AAAAAHIikyRJsrVF1q5dGy+88EI8/vjj8dRTT8Wuu+4aPXr0iJ49e0b79u0rVauoqCg6depUqWvWr18fr7zySpSWllbqukIrKSmJ9957L84888xCtwIAAABVyrx582Lq1KlbXScnwcfXJUkSM2bMKDvrY/ny5XHyySdHjx49onPnzlFcXLzJ64uKsjtvNZPJbJfBR0TErFmzCtwJAAAApFPOg49veuihh+KSSy6JpUuXxk477RQrVqzY5PyioqKYNm1apdZYuXJl9OzZU/ABAAAAlJOTMz5at24d8+bNi4iIDRs2xB//+MeyHR8LFiwoO/D0q7/ob07Hjh0rtf7y5ctjG+c3AAAAwHYoJ8HHggUL4vHHH4/HH388nn766fj0008jSZKoU6dO9OzZM37wgx9E9+7do1GjRputNX/+/EqvX69evayuAwAAANItJ7e6FBUVRSaTiSRJYrfddovu3bvHD37wg+jSpUvUqlUrF32mkltdAAAAYNvKyY6PiIhLL700evbsGcccc0xkMplclQUAAADIWk6CjxYtWsTIkSNzUQoAAAAgZ7J7duw3OF8DAAAAqIpydqtLRMTHH38cEydOjD/96U+xbNmyaNiwYXTo0CHOOuus2G233XK5FAAAAMBm5eRw04iIhx9+OM4999xYtWpVuUfLZjKZ2GmnnWLcuHHx4x//OBdLpUZJSUk0bNgwWrduXehWAAAAoEqZN29eTJ06davr5GTHx4wZM+InP/lJNG3aNPr16xdt27aNnXbaKVatWhVz5syJRx99NHr16hXNmzeP9u3bV6r27373u4iIaNWqVfy///f/ctFuldK6desYM2ZModsAAACAKqV///45qZOT4GP48OHRs2fPeOCBB6JGjRobvT9ixIjo1atX3HDDDfHkk09WqnafPn2idu3acemll6Yy+AAAAAC2nZwEH6+++mrMnj27wtAjIqJGjRrx3//933HYYYdVunZRUVFMmzat0jtFAAAAAHLyVJdVq1ZFkyZNNjmnSZMmsWrVqkrX3n333aNt27abnffBBx9UujYAAACQbjnZ8dGyZct47rnnomfPnt8655lnnolWrVpVuvYpp5wSTzzxRPz0pz/d5LxWrVpFaWlppesX2tixY2Ps2LGFbgMAAACqlH79+uWkTk6CjzPOOCP69OkTt956a5x22mmx8847l723cuXKePDBB+O//uu/4rLLLqt07eHDh8dZZ50VixYtilNPPTX22muvKC4u3mhejh5OUxBTxuS/9y79M/Fpkt9DVRtl+u8QaxZq3UaZ/nFrvcZ5XTMiYuCKj/K+biHW/GrdZZdendc1G/xqeJx660N5XTMi4uGBp+V93UKs+dW6ydP5/T6c+X5mh1izUOtmvp8p2PeIfP+e3qV/pmB/jijEZ/X9MH3rFmrNfP9+HvGf39ML8eeIQn3W55fl93tEtwaZvK9ZqHW7NcjE2B/m/x/P+/2+X97XfSPeyEmdnAQfl19+eUyaNCn69+8fAwYMiD322KPsqS5LliyJJEniiCOOiIEDB1a6dr169SIi4sknn4xrr732W+dlMpms+wcAAADSKSfBR506deKll16Ka665JsaNGxeLFy8ue69evXrRr1+/GDp0aNSqVavStZMkiY4dO252zh//+MdK1wYAAADSLSfBR8R/wo/bbrstbr311nj33Xdj+fLl0aBBg2jbtm0UFW3dGarTpk3b7JytXQMAAABIn5wFH1+pVq1aHHDAARW+98Ybb1T6sbQ33XTTFs0bP358peoCAAAA6ZfXbRJHHXVUpa+54oortmhe7969K10bAAAASLesdnwMHTo0131s1rJly+LRRx+NmTNnxkcffRSPPvpo/P3vf4+lS5fGd7/73bz3AwAAAFR9WQUf119//UZjXz1VpaLHymYymUiSJOsnr9x3331x4YUXxsqVK8vVWbRoURx//PHRt2/fuPvuu7OqnQ8lJSUVjs+ZMyfPnQAAAMCOJeszPr5+4GiSJDFs2LBYu3Zt9OrVK5o3bx4777xzrFy5Mj744IO4//77Y8WKFXHbbbdVep0XXnghevfuHS1atIgBAwZEs2bN4uKLL46IiE6dOsUbb7wRp5xySowbNy769u2b7ccBAAAAUiir4KO4uLjcI2ZHjx4d7du3/9aDSM8///y46qqr4uWXX47OnTtXaq0RI0bEOeecE2PGjCl7cstXwUdExOGHHx533nln3HDDDVU2+Jg1a1aF4yUlJTF79uw8dwMAAAA7jqwON/3iiy/Kvf6f//mfGDhw4CavGThwYNx3332VXmvmzJlxww03bPJxtZ06dYr333+/0rUBAACAdMvJU13mz58fxcXFm5xTs2bNWLx4caVrr1mzJurVq7fJOcuXL4+1a9dWujYAAACQbjkJPho3bhxjxozZ5JwxY8ZEkyZNKl173333jQkTJmxyzoMPPhj77bdfpWsDAAAA6Zb14aZf95Of/CQuv/zyeOutt+L000+PfffdN3baaadYtWpVvPvuu/F///d/cf/998c111xT6dp9+vSJiy66KP70pz/FeeedFwceeGBERJSWlsbChQtjwoQJMXLkyKwOTgUAAADSLSfBx+DBg2P27Nlx7733VniOR5IkcdJJJ8W1115b6doXXnhhvPjiizFx4sT43e9+VzZeXFxc9ujcH/7whzFgwIDsPwAAAACQSjm51aW4uDiee+65GD9+fHTq1CkaNGgQRUVF0bBhwzjhhBPi3nvvjUmTJkXNmjUrXbtatWrx+OOPx+233x777rtvJEkSSZLEhg0bYv/994877rgjHn744chkMrn4KAAAAECK5GTHx1d69+4dvXv3zmXJiIjIZDLxi1/8In7xi1/E559/HitWrIgGDRpEnTp1cr4WAAAAkB452fGxpYYOHVrpaz744INyr+vWrRtNmzYtCz1uueWWuPfee8tuewEAAAD4Sl6DjyFDhlT6mlatWm3y/T//+c8xYMCAuPjii7NtCwAAAEipnN3q8thjj8V9990X77//fqxevTpnOzA2V+d///d/45133omuXbvG7bffnpM1AQAAgHTISfBx++23xyWXXBIREY0aNYq6devm7LDRLanTqFGjWL16dU7WAwAAANIjJ8HHqFGj4vTTT4/bb789Gjdu/K3zioo2f2fNxIkTY+LEieXGjj/++G+dv2bNmpgzZ04ceuihW94wAAAAsEPISfCxZMmSGDVq1CZDj4iIwYMHb7bWggULYvr06WWvM5lMudff1LBhw2jfvr3bXAAAAICN5CT4+M53vrNFZ3psSfAxePDgcvOKiopiw4YNW9UfAAAAsGPKyVNdrrzyyhgxYsRm51WrVq3StXv37p1NSwAAAAC52fGRJEn89a9/jUMPPTR69OgRTZs2jdq1a+eidCxYsCCOP/74OP744+Paa6/NSU0AAABgx5CT4KNPnz5l//3WW29FxMZPY0mSJKsnvbz00ktx3HHHxZFHHrlVPQIAAAA7npwEHxER48eP3+T7SZLEueeeW+m6tWrVikceeSQaNmyYbWsAAADADipnwceWnMXRt2/f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u3bt8hZ8AAAAANuHrM/4mD17dhQXF8d3v/vdsl0dBx10UC5722JLliyJf//73wVZGwAAAKi6sg4+nn322Tj22GOjdu3auexnIx988MG3vrdq1aqYO3duDBs2LPbff/9t2gcAAACw/ckq+GjRokV069Yt171UqGXLlpt9YktxcXE8+eSTeekHAAAA2H5kFXxU9JSVbenss8/eaCyTyUTt2rWjTZs2ccopp8Ree+2V154AAACAqi/rW13yafz48YVuAQAAANgOFRW6gc2ZNm1aoVsAAAAAtlNVPvjo2LFjRESsXr06lixZEp9//nmBOwIAAAC2F1U6+PjLX/4S5557bjRr1ix23nnnaNasWdSvXz/22muvGDBgQPz1r38tdIsAAABAFVZlg48hQ4bEoYceGuPHj48PP/wwkiQp+7F48eIYO3ZsHHbYYXHTTTeVuy5JktiwYUOBugYAAACqkip5uOngwYNj2LBh0aZNm+jVq1d06NAhmjVrFnXq1InVq1fHokWL4vXXX4/7778/rr322shkMnHllVdGRESbNm3is88+i08++aTAnwIAAAAotCoXfLzzzjtx4403xvXXXx/XXHNNVKtWbaM57dq1ixNPPDGuvfbaGDZsWAwaNCh+/OMfR/PmzePDDz+MkpKSAnQOAAAAVDVVLvi444474qyzzopBgwZtdm61atXi+uuvj4ULF8bo0aPjgAMOiDVr1sT555+fh04BAACAqq7KBR/Tp0+PBx54oFLXXHjhhdG1a9dYvXp1DBgwIM4888xt1B0AAACwPalywcfixYvjgAMOqNQ1BxxwQHz22WcxceLE+OlPf7qNOgMAAAC2N1XuqS5FRUWxfv36Sl1TWloa9evXF3oAAAAA5VS54KNFixbx5ptvVuqaP//5z9G6dett1BEAAACwvapywceJJ54YI0eOrNQ1t956a3Tt2nUbdQQAAABsr6pc8HHRRRfFlClT4mc/+1msWrVqk3NXrVoV/fv3j8mTJ8eFF16Ypw4BAACA7UWVO9y0WbNmcdddd0WfPn3ikUceiR/84AfRvn37aNasWdSuXTu++OKLWLRoUbzxxhvxxBNPxKeffhp33XVX7LnnnoVuHQAAAKhiqlzwERFx9tlnR61ateK8886LcePGxfjx4zeakyRJ1K5dO+6+++4455xzCtAlAAAAUNVVyeAjIuK0006L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OXJkRES0aNEikiSp0n/hrao6deoUSZLE+PHjIyLiz3/+cwwcOLDCudOnTy/7/zR48OBIkiT69OmTx24r1qdPn0iSJHr37l3oVjZp/fr10a1bt7jiiiuiV69e8de//jVWrlwZr776apx99tnxwAMPRK9evbaLnRT77LNPPP/883HttdfGXXfdVeh2ALYbgg8Acq5jx45RXFwcb775Znz88ccbvT9lypSoXr16LF++PF5//fWN3p88eXJ06dIlMplM2djRRx8dH3744Wb/Ys7GRo0aFX/84x9j1KhRUatWrQrntGjRIiIibrrppk3Wuvfee6OoyB8fcqlOnTpRo0aNuOOOO+L3v/99odtJnQceeCCmTZsW1113XVx44YWx5557RnFxcTRv3jwuuOCCGDNmTKFbrJSSkpLo169fXHbZZfHBBx8Uuh2A7YI/uQCQc3Xq1Invfve7kSRJTJ06tdx769evj+nTp0e/fv0i4j8hxzdNmTIlunbtutF448aNo0aNGtum6ZRau3ZtjBw5Mjp16hQlJSXfOq9Xr17RtGnTeP311+OFF16ocM6GDRtixIgRcfnll2+rdndIu+22W4wYMSIiIs4999xYuHBhgTtKlxkzZkRExEEHHVTh+z179owWLVpEzZo189nWVrnsssti9erVcdtttxW6FYDtguADgG2iW7duEbFxsPH6669HkyZN4txzz42I//+2l6+sWbMmXnnllXLBx9fPovj6eRJLly7d6NyD3/3ud7H//vtHcXFxtGzZMkaNGlVhf2vWrImrr746mjdvHrVq1Yq2bdvG7bffvskzLlatWhVDhgyJtm3bRq1ataJRo0Zx8sknx2uvvVZu3jfPOfl6z2vWrImdd945LrnkkrKxBQsWlJv/1W0MpaWl8Zvf/CYOPfTQqFevXuy2225xzDHHxM033xyLFy/+1j6/bvLkyfHRRx9F586dNzmvZs2acemll0ZExPDhwyuc88gjj0StWrXi+9///iZrrV+/Pm6//fY45JBDonbt2tGgQYPo0qXLRiFYRMSiRYti6NChceSRR8auu+4atWrViv333z+GDx8e69at22j+F198ETfddFMccMABUbdu3dhjjz3i+OOPj9GjR8enn34aERHXX3/9t54/Urdu3QrPyXjwwQfL/T94//33Y/DgwdGqVauoXr36Rue+/POf/4zzzjuv3O6Bn//857F06dJN/tx8m0suuSR++MMfxmeffRZnnnlmrF+/frPXfPOckK/fctS9e/eNfj1FVPw1M3HixNh3332jTp060b59+3jppZciIuLtt9+OTp06RZ06dWKvvfba7LkSX375ZVx33XXRsmXLKC4ujjZt2sStt94aGzZs2Gjulv4aufnmm8v1+/nnn8cvf/nL2HPPPaNatWpbdN7JzjvvHBGx0dfpV2rWrBkLFiyIo48+umzs61/Dffr0iWeeeSaOPvroqFu3btSrVy969uwZc+fO3ajWtGnTom/fvtG2bduoU6dO2ed68cUXN5rbtm3bcmu8/vrrceyxx0adOnVi1113jQEDBsQXX3xRYc8tW7aM1q1bx/33379F5/IA7PASANgG3nzzzSQikj333LPc+KBBg5Lzzz8/KS0tTXbZZZekevXqybJly8renzx5cnLIIYdUWLNFixZJixYtNhofP358EhFJ586dk1/+8pfJ4sWLkw8//DA5/fTTk4hIHn744XLzN2zYkHTr1i2JiOSWW25Jli9fnnz00UfJFVdckRx33HFJRCSDBw8ud83nn3+eHH744Um9evWSRx99NFm9enUyf/785JRTTkmqV6+ePPjgg+XmX3bZZUlEJI888ki58UmTJiURkbRu3Xqjz3HkkUeW6/XSSy9NqlevnkyYMCFZvnx58umnnyb/8z//k1SrVm2j/r7NJZdckkRE8thjj33rnI4dOyaDBw9OVq5cmTRs2DCJiGTGjBkbzTv44IOTBx54IJk/f34SERX+vygtLU169OiRFBUVJb/+9a+TlStXJosXL0769u2bZDKZZOLEieXmjxw5MqlZs+b/196dB1VVv38Af182BcQQBBFFWQQxsRAEUxxFHMsNXMAVBVNCXFPLfcfKmTQ1GnOEGFCzEcIVM8yQNFcQTRR3RSlQEBXlCwJefH5/MOd4zz3nIihMv/B5zTgTz/mc7XM/hzjP/SwUGxtLxcXF9OjRI0pMTKQWLVpQUFCQ7PgjRowgMzMzOnDgAP3vf/+jgoICWrlyJQGguLg4SdlXtRft8kREoaGhBIAGDBhA69ato8LCQrpy5QpZW1uLdX758mWysrIiJycnOn36NJWXl9PJkyepQ4cOZGdnR3l5eTrrWulahGssLi4mR0dHAkALFiyQlRU+J13XnJOTI4kLn1NoaKjOOujf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\n",
      "text/plain": [
       "<Figure size 648x432 with 7 Axes>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 383,
       "width": 543
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "bach.plot('key')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "A Key object is derived from a KeySignature object and also a Scale object, which we will explain more about later."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "('Key',\n",
       " 'KeySignature',\n",
       " 'DiatonicScale',\n",
       " 'ConcreteScale',\n",
       " 'Scale',\n",
       " 'Music21Object',\n",
       " 'ProtoM21Object',\n",
       " 'object')"
      ]
     },
     "execution_count": 51,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "k = key.Key('E-')\n",
    "k.classes"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "But for now, a few methods that are present on scales that might end up being useful for Keys as well include:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<music21.pitch.Pitch F4>"
      ]
     },
     "execution_count": 52,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "k.pitchFromDegree(2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "(octaves in 4 and 5 are chosen just to give some ordering to the pitches)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'mi'"
      ]
     },
     "execution_count": 53,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "k.solfeg('G')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Key Context and Note Spelling\n",
    "\n",
    "`Key` and `KeySignature` objects affect how notes are spelled in some situations.  Let's set up a simple situation of a F-natural whole note in D major and then B-flat minor."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 54,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 364
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "s = stream.Stream()\n",
    "s.append(key.Key('D'))\n",
    "s.append(note.Note('F', type='whole'))\n",
    "s.append(key.Key('b-', 'minor'))\n",
    "s.append(note.Note('F', type='whole'))\n",
    "s2 = s.makeNotation()\n",
    "s2.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "When we transpose each note up a half step (`n.transpose(1)`), music21 understands that the first F-natural should become F-sharp, while the second one will fit better as a G-flat."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 55,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAr0AAABiCAYAAABd02sLAAAACXBIWXMAAB7CAAAewgFu0HU+AAAbcUlEQVR4nO3deZQcZbnH8W+YLAxkCCGQQAIkSCQQIWAAQQSMIIgEFxBRcQMUWbwBvSKXeI4bm3IQgktURAVBERUhKMoaUAwE0ChelhDgQsAAYU0gTEIySeb+8VRRb1dXVVd1V1X3dP8+5/Tp6lrf9EDNM2897/NC+Q4AXgB6gclNuL6IiIiISKE+DfQB/d7rQaC7qS0SEREREcnRR4F1BAGv/zq3mY2K0AVcBJzU7IaIiIiIyMCyJ7Ca6oC331u/Y/OaVmU7rF1PNrshIiIiIjJwjAAeJzrg9V/XNqFd3cD4iPUTsTYtKbc5IiItYVPgG8D3gX2b2xQRkYFlFskBbz+wHtit5HZd4117ami9gl4R6WRvJ7g3/67JbRERyc0GBZ//zcDnU+w3CPhKwW0JGx16FxERWOss9zWtFSIiOSs66P0KMKTGPsu998OBscU2R0REanCD3jVNa4WISM6KDHrHAkcnbO8DLsAGji0FBgOfK7A9IiJSm4JeEWlLRQa9HwOGxmx7BpgGnIb19M711n+6wPaIiEhtSm8QkbZUZNB7eMz6RcDuwF3Our977xOwQRStZCqwS7MbISJSknXOsnp6RaRtFBX0bgjsHbF+MTYN8dLQ+vud5Y8U1KasNgMeBhYA/0L5xiLSGdze3TKC3tGoRJqIlGBwQefdGZvZzNUHHIWlNoS5E0EcUlCbahmJzRp3nPe5G5jkLXdhQXBU20VE2onb01tGesM+wNe95S2BeSVcU0Q6UFFB76SIdWcTpDGEvRw6dhzwdN6NirE/cCzwAWBYSdcUEWlVZQ9k64tZFhHJVVFB78jQ52eA8xP2Xxn6vC/wm1xbVGlvLLAGmFngdUREBpqyg941McsiIrkqKqe3J/T5PGBVwv7doc9vybc5b9gNeBCYjw2aS+sVNEObiHSGsqs3lJ1DLCIdqqigd5CzvAb4ZY39Nwl93inf5rzh/cDklPv2Y7llM7CZ5ZYn7y4i0haa2dOr9AYRKUxR6Q3rneVbqMzZjTIh9HlMrq0JhAfXRVmGpWc8A+xXUDtERFpVM3N61dMrIoUpqqfXvYndmWL/nUOfR+TYljSWAz8H3k10qTURkU6hnF4RaUtF9fS+7iz/M8X+e4U+F9Wu/oh1M4FZwGrv88SCri0iMhCUXbJM1RtEpBRF9fT2OsvPpWjDe0PrXsm3OW/4OzYT3OkEE2LcRxDwioh0unUEHQTq6RWRtlFUj+qrznKtAWD7A1uE1i3Ltzlv+JP3AqvLKyIi1fqAoVQHoV1YtZ3Xcr6WT0GviBRmMPCzAs67pbP8HZJ7bg+IWLctxbTL5acxfBH4sLPeryQxsoQ2iIjUa3tgK+BRaj9Ry8qvwHMyNjX8ZGA8wXiLlcBD2BOzqLSxLDZylg/HquWIiMTpBnb3ludTmZIFMBZ4U9SBg4HHC2jQK8Ch3vILxNe4HYkFuGEPF9Qul593/GzoWqO897UZ2+CnabwA3Ntw65JtB7wL+16fxHrW12Azym2J/bDHYBN8vFhwW0SkOd4C7IBVx5mf87nXAkOw6dffifX6ujYC9vDW/7bBa7lB7/MUf+8XkYFtc+zeBxbnhFNUxzjbSzGMIC/swwn7XeHtE35NKLh9YDV4+4FDQusneuuzTkaxnXfck403raazif7e3Nd8YMMS2iIizTEb+3896YnUxtgfyIcS3cEQZynBvaQPuAA4Ehv0G77XHJOx3WGbOOc6ocFziUj724HgnhGe5wHgFGJio6IGsq0GFnvLk2L2mQp8PGL9P51jm2kodgO+BbiWoKejG3vMF9YVei9SeJrnsMexiTher7GfiLS3g4DbsLEMF2Q4zs2zPRr4EnA1lg4WnmzojEYaiHJ6RaQkRQW9AP/23sM1eMECw59QOXOb76rCWlTbBtgjO7DBdT/Gavd+kCAH+FdYUD617MY5NkvYtgyYjqVZiEhnq7ccmB98Pgr8LrTtJ6HPk4BxGdvlUskyESlFkUHvPd571GQPpxIkIbtWAJcU1qJ4e2KP7ZYAv47Zx/+uRofemyEyQRv7RXUElhMtIlJvOTA/+HwgYlvU/SVcgSeLtZRbIk1EOlRRJcsA7vbex2ODq5Z6n6cA58Yc8yNqlzjL25XUThdoJUOAXWO2HQ/8Bct3mQ/sgk2nLCKdqd7UAX/flRHbhkWsa3QsQ5kl0kSkQxXZ03s3QU7pO733bqwnNeqmuZT4YDgvw7BBFzcQzAKXNuBtlfzYKUR/f2cBl3vLZ2IpEGPLapSItCQ3iMySOpC0b/iP7nk0Xlvdb2cfVobtW8BC7/MK7CncGZQzZkJE2lSRQe9qgjI6B3vvl2D1HqN8geJmYvOdAFyKVWxI28v9JPBl4LGiGpVRVF3jXwFf85b3w+pqiog02tMb5XOhz+dkOG8cv51HAI9gAe6OBOM+xmGB8BU5XEtEOlSRQS/Ard77wdio36hqDQB/xGqtFW1U7V3e8CrW7u2wCTaymoqlF+Tt/aHPfwOO85ZHAZcVcE0RGZgazekN2w94n/P5F8CN3nIPNtPlx8k+wYTftuOwUosXYuUuLwrt9zEaL5EmIlKItxLUR1tHdN205ylvUNg3Y9rQjw2muAE4jeQ6vbXq+67EBnr458wzxWALgkEf/cAigkoOY4AFVP6b9og4h4i0hzR1eicT3A/OznDuW71j3IG9I7FqDv75bqQy1Wq6sy1c8aGW/zjHhmu7h+u5a6CuSGdruTq9vn9hM55BfK/yZ7HAt1kWYY/StsVmVJuT8fiRwEkEvxy6CWoTd5FcXiyrEwly2l7Efsm8jE0V+hDNLaMmIq2n0Z5evz55D/AHgtKNs4DDqJwJqZHSY1lLpI3JeH4RkUKrN4D14Cbd/GZhN9Ky9HrvS7DgdBSWS3xj7BHx9geOxR7nRQ0sy9sw4PPe8mqsdvBj2GPE2SVcX0QGnkZzekdiAeafsDKTvcBniE5HqzfAhuwl0kYCz2W8hoh0uCKD3m4soI2b+vIu4PQCrx/lEqyqxDzgDuAdGY/fm6AI+8wc25XGDOyXjz/t553eelVoEJE4jVZvmIzdMydgEw59BHs6FmVtzHXTyFoiTaUYRSSzQcCDBZ17G+yRWJS12FS5a2O2l2ECsBHwFJU1IIdij/DWYqOIweav35LsPbrrscd16xppKPbHyUQsReR5LLXBtzHR0yIDPAGsavDaItKatsJ6PJP+P+8iSLdaiqVDpTEOGOF8fhnrWe2P3h2wjo7tvOVlBKltabwJG8D2CvB0aNtwKjtPVtIaU9WLSHP4cRrYk6D1oe2bYTFblcFYwm/eTiW+NNlqrJLDIzHby/Jd4C3YhBh/d9aPw0YkLyf4bs4hPrAM68f+kPgLcDv5lGH7Kpa4fSPVlSR2BS6IOe58mv89i0gxTsGquSzEqh1E2Ygghewq4PqU5z6NYLDub6nOq40yEZu6HeA27N6a1veBnYB/YKXJXGdSGfSeReU9W0Q6y9YElapOp/oJ0eEE6aCF+yLxFRL6gU+V1ZAaalVhcKs33ETyv6kf6wlJqvpQrwO9887FZmMLm5bQJlVvEGlfaao3dBPcD47NcO59sXvkWaQvbbmzc63zMlwLLN2sH/hlaP1+WC+Of97LnG2bAp/EfrntnPF6IjJw1V29Ie+c3sOoXdM266jeVrYcuAabyvg/xOe61asHy0NeCHyI9vruRKR49VZUmIcFvmVcC4KcXnfGtZHAzwkmqLgJm2DIN41gFsqrqS51JiJSIc+SZTtiM4PFndO/qb0vZnurWIbdsN2RwVF5bDOxnJHPYL2w4ZySPPwQy9k9FAuwRUSy8Ot6Q/bBZVnVWynCPbasEmki0oHy6undFLiO6G5mvG0LsNysg7HAuIggMQ8vYYPcep11f8RuwnOwx2m7APdReQPO2wysd/ddaNCGiNSvDwsmw4FoF5b+8FrVEfVfx1dv9YaySqSJSAfKI+jtwiZm2CFm+93Y1JE7YkHvKCzX9N4crt2IdaF3V7gczmyCWrgfKKxFgR5scNpy4gep+UYkbPsplb/QFmCDDEWkc6zBgt4+rOLDKVid70lY6sDTwA+wga+NVJqptzyau3+WEmmNBNki0oHyCHrPoXowmO8xLJ1hFdYz+gI2le57aH7QeyHWpnua3I4or2HVJQ4BNq+x70YJ2zbFygD5xsXtKCJtyw8Oj8AqOAwPbR+HVUyYAhzdwHXyqNPrz7Q2G6sg8XqKY0DpDSJSgmlUjqx1Xy8R5GP5rvS2/bW8JuYuS9WHMhxEfPWGvUpui4iUJ031BrD6vP49oQ97enQklicbvmcc00B7epzznFBj37CfOceen/KYPZ1jZmW8nogMXE2p3jAYeyQ2KGJbP/AJrKfXNRdLddgb66GMmn1Hsknqvd2qtFaISKtye0GPBn7nLV+NPUn6hLP9DCrLgtV7naw9vT/Cgub52FOuNJTTKyKZNFK94WRscoco5wI3RKyf670PxeovtqOhWC/HLcC1BKORi3JgwrZ3FnxtEWl9fkD4KEHA6wtPOjGJ+AHJtbjpDVnTDf4BHIX12KYd5KzqDSKSSb1B7+bAN2K2/RX4esy2xdj0w2BVCdrFBgQTQWyBzUr0bmywSDjFI0/bk1yb8tPYwEER6Vx+QPhAxLaHI9YljRNIUmZ5tPA11NMrIjXVG/SejZWWCXsJe3yWNAL4du+9HYLePbGeiSVYBYsoedZCdm2DlVAblrDPSGzyjM0KaoOItD4/IIxKJ4u6fzQydbofYEeVRwsPoGuUqjeISCaDyf4oawJWNzHKl7DKA0nnvNs7fncsaFyFleZ6NWM7msWfMejXWHWEWoZT/+PCKJ/EUkMOwyauqGV/7LHm9Vh6yZwc2yIizeOnTg0h+R6zPmG/t4c+z/f2i5ryPA2/JvAQbLDJicB04M3Y+I9nsJSK79FYeTSoDNi7yPc+KyKty/0Duidi+4YR6wC7CUXNNiYiIgPDUmx2SBERSTCYbI+cNgCeoDpPtBer8fhc1RF2jVOBLxCdEhGlFyvHcz7WE9xsPwQ+lfGYp4CLST8SOYuvAafX2OdebPripDqXIjJwzQKOB27GBhbHuRnYB5vVzH1Ktw9wE0EFnl+RvdRY2OPAaG95LVaV4R6sR/nzoX1PBH7ZwLV6gGe95VOpXbpNRNrDRGyeBbAqVStC208ifenDRG8luvbZ12L2HwvcGXNMmtej2JS/zXYT6dv8ClY7N6qUW178+pxxr//DBtSJSPtKW6f3Vm8/d9zBSOz+6t8zbiR5fEBa/3HOGR5kewWV96moQXRZdDvnOrbBc4nIwFF3nd6sg6z2j1jXC1wUsX40cBvWm1CvicBdtHZ5s3XYL4wve59XYOXKikwbSRqYtgzLoXuhwOuLyMDhD/jyc4B7gD8QVJaZhY0RWJ3DtbKWR2tklkiVLBORTLIGvW+LWHcV1YPQBmGFzyfV06iQ4cCfgR1zOFeeFmGF3LcF3ku5A8TeFLN+DTbVaKM9KCLSPvxAdCQ2ze/twL5Yh8VHgf+mssZuI7KWR2vkiVTZJdJEZIDLGvTuELHusoh1J5LcO7uS4CbbS+1e0eFY6a28S96k5ZfwWYKVZQPLUT4PG41cpiHArjHbjgf+gv2cXsLSS0Sks/mB6GSses7uwL+999/kfK2s5dGebPB6ZZZIE5EBLus0xOFHUUux9IPwOWdGHPsqNm3xb7BegFuxWr1zsCB5T2yw2FFEF0ffCfiOt2/ZTsXaPg+4A3hHE9rgm0L0L4+zgMu95TOxFIixlB+Ui0hr8QPCMd77bOA0ihnkmpRmEP5jfR6WjtWINVjaRh82oOUUbFKgSdgTx6exe/f5NF4iLck47Anctljvdbf36sP+AFiBdZo8haV+5JFKIiIFW0FlUvDFEftMpzp5eC7BiF7ft7xtD4XWj8emMI5KQu7DZiFrpnleWw4JrZ/orV9S8PW/TPX34o6A3s9Zv0fV0SLSLtIOZPsZwT0hlxHNCeZTfU/yXUflfSt8D63HywTfQfj3k/u6ModrhU0CLqByQOBSbODz37zlqLb0YlPUH0VxkxeJtLO6B7JlvdBroYM/GbHPhaF97iIYQOE63Nu+jupJFgZhg+OiGnxp1kbnrNlB79+o/D7uIPh+R2GVGxT0irS/tEHve7Hg8FKCyXWKcgfRQe9+2CQZ/r3pspyu5waWfVgQeiQ2OC/8u+OYnK65Cxa0uv8e/w8K9/sdhD0VvJXo32X9wCPAR3Jql0inKC3ofS508MSIfdzyXn1E5wGDPQ7y94tLF/hxRIOXkz0tI0/NDHq3IBi80Y8NpvMrOYwBFlD5XSnoFWlfaYPeMpVZHg3KLZE2CEsdc+/B/uvfJJepPC3iGPf1W2BEg+0T6RSlBb0POQeuJ7rXwA28rq9xvqe9/WbEbN8Qu5mEGx1VOq0szQx6v0rwHbxA8EfHydjAtfD3pKBXpH21YtDrp6b93vvcQ+XTqQvJt9PCf7L1SMQ2N9XLf6WdICnKpRHn819p6gSfkXB8P1bTXoPvRGorrU7vYmd5BdEDA9yBDOFBbmH3eu9TY7a/TlD/1hWeL74VLMP+7VGz0uVhGMGMRquxwRqPYXPazya5dq+ISBnKLI8G2Uuk9dR5nY+TnB5xf4pzfBsb3xJnH+DcDG0SkYyyBr0POsvh2rw+t6czPDVcmD+N3JSEfW4G/hVa14rzzL8ETAAOKOj8M7BfIn5u2p3eepUlE5FWUWZ5NMheIu2liHVpnFJje9oqOd+usf0EoqsXiUgOBgMHZ9jfLbMyIubY5c7yO7C801p2wdIF1sdsfwibAtm3a8y1y+B3pe9GfHvztjmWSwbwC2xQiv/vT/qDYW/K6wEeDWyDlQ3aDPuFsyH2S/B17JfSUuyXw1OomLxIo7bx3sfSvPthmDvGAGzmt0uwqjzjC7het/e+FdXfQXgypQeov9zkbjW2vwdL16ulC/s9GpfTPBQb2JbmXCKdamtn+QCq/+iNncxsEPC/GS7UhdXL9RP2H6Q68BtGMHhtFfYIPs4Qp3GPEF+7sAfrRfUtxwYwNEM39m98lfKC3m2xPzKWUZ0zvDHxM7Q9hv0MijIM+yW3CUEFibVYkDvI2x6Vv7ceqwSynGDiDxHJZixWseUJ7P+nVrA1Qd7si8CzBV9ve6xnNOp3wngq8/0WU/vpY5ydSM5Ffor097IdSB7I9zCaVlkkiRtnRsWho8jxKfhcgqTguEf57j5JM7NBUGfxown7TKUyGfmHGdo70B2I/ZvnYn8khE0jfmBEUQPZVLJHpPlacSBbmeXRoLwSab8m/h7WD1yV4VxRg7P913KiS3yKSKC06g1gwal/8EUx++yDDXLzg5qkUiy3efudk7DPzlQ2+gvZmjxg9QCPY+kdm8bsM43ygl6V7BFpHa0Y9JatrBJpO2BPsOLuX2upTMFLsizhPGc02E6RTlBq0DsEmy+9HxsUEJ5Ywvd15yL3UD0jm8+/cV+TcE2/t9N/NXMa4DJdgVWDmJCwzzTKC3ovTbiWSvaIlEtBb7kl0qZjKXhx969HsVrqSXZKOP5yNEObSBqlBr1g1QP8E3w1Yb/Zzn5LgEMj9vkvb/vChPPMdM7zIuU8Nmu2GVhy9l419ptGOUHvoQnXyXKtpFSHfuB7ObZZpJ0p6A2mNr4NGzz3D+/zaxSTNvU27HdV3P1rIRbYxonqOOgFTkcBr0hapQe9G2A1ePuxgVJJ/5OfhiXl92MpD+FyY34v7hri/yK/z2nwefU2egDpwb6P57HJMJJe9xP/w70vtO93G2hTeHaj8Ctt0vi7a5xnNfGpHCISUNALV2PfwVJsQJ9/35tU4DU3BL5EMLlS1D3sEmwSJf9J6GhszIO73yps1tEJBbZVpB2VHvSCVV1Y6Z3kYZLzMadgPXy/p7qX1p2OOKrMxHRn+wqsNE27G4TdIO/Hvtuk11PE/3AXh/a9uoE23ZNwnX5skow0BmM9G0nn6pT0FZFGKOiFK6m8d/wAC0rLMBQ4AisjuZT4+9lKZ7kXS8k4mfiUPxFJ1pSgF+Bo50TzYy6exmveOd4XWr8JwV/v/cAX6zx/OzuI+B9urdSILG5JuE4/cGSGcz1Y41xpB4SIdDIFvfZv9+8b5ze5LWOAdwGfAE7CnnLOwNIBD8PKqymFQaRxTQt6wXJ6/ZMtInmyhDgPeMef6qzrwnqG/XNfR3J1gE51DPE/3A/meJ1vJ1ynn3xL9nTHHyoiHgW95ZdIE5Hma2rQC/BN54SrsL9uo2rKxrneO9YfxDQCq+bgn/MONDVjnKRc21k5Xmc8Ktkj0koU9IpIJ2p60AvW47jKOfFi4LPElzRz/cA7Zi5wIjazjn+ea1OeoxNtT3Ig+jI2M0leVLJHpHUo6BWRTtQSQS/AZKoHPK3G8kHPwHKdDsIGKh2IPX4/mcoZ3PzXCmwSCqU0RNuG5MoN/uuv2FTBeVHJHpHWoKBXRDpRywS9YEHqUcCChIsmvZ7F8kfHFdG4NnAcltKwgvTf6YvAT4EP59QGlewRaT4FvSLSieoOegdhM6cVZSusXuJ47LF3eLatNcArWJC0tdeos7F6vhLtg1gd217gVWzg18vY97jK22cjb5/NvPdNvHVPAzfn2JYu7D++HbFUi7jZ1PoIcrz7sBn9FmHTK/fm2B6RTjId2BN7unZDk9siIlKWUdjYMYBvYTGkay9skGuVQcDFxbWrygZUBj/rveVNsd5hgMuwYFgGnm5s3vuNsZ/zYOxnvAbLPV5O0EMtIo2ZiHUsPIY9IRMR6QTdBLPA3kV1R+lYrCOuZW1J0P08vsltEREREZE20yoDh1Y6yz1Na4WIiIiItKVWCXrdfAxNTCAiIiIiucor6D0YmAM8jwWwi7CZ2tLOgb7eWc4yqYWIiIiISOEGYwPP4kplzSN+RL9rY+eYtxXRUBERERGRev2Y2jViL09xns2d/XcppKUiIiIiInWYgqUl1Ap61wNvrnGu7Zz9W7rMhIiIiIgMPI3k9L6fdFMED8KmHE6yjbP8fN0tEhERERGJ0EjQOzbDvqNrbPd7d5dhkxeIiIiIiOSmkaB3eYZ9n6ux/QDvfWGdbRERERERidVI0PtMyv3WAjcmbB8KvMdb/lMD7RERERERyd0Uag9i6wfOrXGezzr7Ti6qsSIiIiIi9XqC5KoNF5HcmzzcOcecQlsqIiIiIlKn4wmC3FXAj7C6vGcDu6U4/mLv2LXArgW1UURERESkIV3AAoLAdw7p84T/xzluZiGtExERERHJybZYdQY/gL2d5HJmw4HZzv7Xka7er4iIiIhIU00BniQIZHuBy4APAXtgqQvTgVnAUme/32PVG0REREREBoQxwDWkq+jQi6U0dDWlpSIiIiIiDdob+ClWxzcc7C4EzsRSIkRERERESvH/1BwKBWv5gLMAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 350
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "for n in s2.recurse().notes:\n",
    "    n.transpose(1, inPlace=True)\n",
    "s2.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Example: Prepare a vocal exercise in all major keys, ascending by step.\n",
    "\n",
    "Let's create a simple exercise in playing or singing thirds.  I think I remember this from the [First Division Band Method](https://www.google.com/search?q=First+Division+Band+Method&tbm=isch) \"Blue Book\": "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 50,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "pitchStream = stream.Part()\n",
    "pitchStream.insert(0, meter.TimeSignature('4/4'))\n",
    "for step in ('c', 'e', 'd', 'f', 'e', 'g', 'f', 'a',\n",
    "             'g', 'e', 'f', 'd', 'c', 'e', 'c'):\n",
    "    n = note.Note(step, type='eighth')\n",
    "    n.pitch.octave = 4\n",
    "    pitchStream.append(n)\n",
    "pitchStream.notes[-1].duration.type = 'quarter'\n",
    "pitchStream.makeMeasures(inPlace=True)\n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This melody does not have a key associated with it.  Let's put a Key of C Major at the beginning of the piece:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 57,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 50,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "k = key.Key('C')\n",
    "pitchStream.measure(1).insert(0, k)\n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note that putting the key of C into the Stream doesn't change what it looks like when we show the Stream, since there are no sharps or flats.  But what makes the difference between an instrumental and a vocal exercise is the act of transposition. When we transpose the `Key` object up 1 semitone, to D-flat major, it will show up:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 53,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "k.transpose(1, inPlace=True)\n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now the key signature is D-flat, but the notes are still in C-major, so we should transpose them also:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAABdgAAABiCAYAAABDJrG8AAAACXBIWXMAAB7CAAAewgFu0HU+AAAgAElEQVR4nO3dd7gcdb3H8fdJ74VUEgKhhFCkq/RqoSNFacIVAREUBLGhj4oCdgSvingpCopXEVSwISCg0uMF6aEnoYQU0uvJOcm5f3xnnp0zO7M7dWd29/N6nnlmdnbK78zZnZ35zu/3/UHjHQQsBFYB2xWwfxERERERERERERGRpvMRoAvocYZngcGFlkhEREREREREREREpOROBNZTCa67wzeLLJSIiIiIiIiIiIiISJm9C+ikOrje48zfpriiiYiIiIiIiIiIiIiU00jgVYKD6+7wh8JKF8144GvAj4B9ii2KiIiIiIiIiIiIiLSLK6kdXO8BNgA7F1XACI6mUtZbCi6LiIiIiEgaY4D9gKFFF0REREREpNn1y3n704BPRliuA/gScHy+xUmsK2RaRERERKSsNgK2d4btPNMTnPc3B1YVUzQRERERkdaQd4D9S0D/OsssBUYBxwCTgLk5lymJdSHTIiIiIiJFG0UleO4dJhZZKBERERGRdpBngH0ScHKN97uAHwKXATOxG4CzsFznZeOtta4Au4iIiIgUYSTVtdG3x667k+iTUblERERERCQHnyE85/qbwF6eZW9y5s9qcBmj2otK2a8quCwiIiIi0tpGAHsAZwBXAHcCb1C/X6O4w96N+oNERERERFpVnjXYjwmZ/wJwADDPM+/fwIeBqcCewMM5lisJ1WAXERERkawNo7o2+vbAlAbtv6NB+xERERERaVl5BdgHYbVu/GYDB9E7uA7wtGf6BMoXYG9kDvYxwHnO+GbggZz3JyIiIiL5Gkp1IH07YLMiCyUiIiIiIunlFWB/B9DXN68LOJ7gTkzneKYPyalMaXSFTOdhZ+BiZ3oiCrCLiIiINIshwLZU10ifWmCZgnQCA4HVRRdERERERKTZ5RVgnx4w7zIsFUyQxb51J2N52suikTXYuz3TeQfzRURERCS+wfQOpLu10zenXGlXFgHPBgxXA8fR+xpcREREREQSyCvAPtr3ei7wvRrL+2vP7IOlRymLRuZgV753ERERkXIYBGxDdY30LShXIH0JwYH0BVhnpiIiIiIikpO8AuzDfa+/A6ypsfxg3+vtsy1Oat5Ad961yr012BVgFxEREcnfIKwV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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "for n in pitchStream.recurse().notes:\n",
    "    n.transpose(1, inPlace=True)\n",
    "    \n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Notice that we choose a semitone transposition and not a diatonic transposition such as minor second (`\"m2\"`); minor second would work just as good in this case, but then to do another half-step up, we would need to remember to transpose by an augmented unison (`\"A1\"`) so that D-flat became D-natural and not E-double-flat.  The semitone transposition is smart enough to make sure that the `Key` object remains between six-flats and six-sharps. Not only that, but the notes will match the best spelling for the current key signature."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 60,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "k.transpose(1, inPlace=True)\n",
    "for n in pitchStream.recurse().notes:\n",
    "    n.transpose(1, inPlace=True)\n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 61,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 49,
       "width": 748
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "k.transpose(1, inPlace=True)\n",
    "for n in pitchStream.recurse().notes:\n",
    "    n.transpose(1, inPlace=True)\n",
    "pitchStream.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "So, we can make a nice, ascending vocal exercise by varying the transposition amount from 0 to 7 (or however high you can sing) and putting each of the two-measure excerpts together into one Part.\n",
    "\n",
    "We will introduce the tinyNotation format here, which will be described in the next chapter:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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kiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJkiRJ/z979x0uSVkmbPw+MzAwMMAMaRAEBhhAQIaggEhQRFd0EQOuaRRwF9fEGtdd9dv9ZM2ugV1zFhEQF8zrGllRSQaQKCBIkDRIHGaIE873x9P1dZ8+3X2qu6q6qrrv33X1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SZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIk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JEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJP2/9u48XJKqPPz4d1YYdmbY92XYdwQZd0UUVFRcAQXUxDUhkcQlwZ9LXINBxUREjWhMRBBFRVzAAIKIoKJsAwKyDTLs6zBsAzNzf3+81bk9Pd33VnWt3f39PE89fW/fqur3Vtdy6tQ575EkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIk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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 468,
       "width": 752
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "out = stream.Part()\n",
    "for i in range(0, 8):\n",
    "    pitchStream = converter.parse(\"tinyNotation: 4/4 c8 e d f e g f a g e f d c e c4\")\n",
    "    \n",
    "    if i != 0:\n",
    "        # remove redundant clefs and time signature\n",
    "        trebleClef = pitchStream.recurse().getElementsByClass('Clef')[0]\n",
    "        fourFour = pitchStream.recurse().getElementsByClass('TimeSignature')[0]\n",
    "\n",
    "        pitchStream.remove(trebleClef, recurse=True)\n",
    "        pitchStream.remove(fourFour, recurse=True)\n",
    "        \n",
    "    if i % 2 == 0:\n",
    "        # add a line break at the beginning of every other line:\n",
    "        pitchStream.measure(1).insert(0, layout.SystemLayout(isNew=True))\n",
    "    \n",
    "    k = key.Key('C')\n",
    "    pitchStream.measure(1).insert(0, k)\n",
    "    k.transpose(i, inPlace=True)\n",
    "    for n in pitchStream.recurse().notes:\n",
    "        n.transpose(i, inPlace=True)\n",
    "    for el in pitchStream:\n",
    "        out.append(el)\n",
    "\n",
    "out.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And we can listen to it as well:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "metadata": {
    "tags": [
     "nbval-ignore-output"
    ]
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "\n",
       "                <div id='midiPlayerDiv17713'></div>\n",
       "                <link rel=\"stylesheet\" href=\"//cuthbertLab.github.io/music21j/css/m21.css\"\n",
       "                    type=\"text/css\" />\n",
       "                <script>\n",
       "                require.config({\n",
       "                    paths: {'music21': '//cuthbertLab.github.io/music21j/src/music21'}\n",
       "                });\n",
       "                require(['music21'], function() {\n",
       "                               mp = new music21.miditools.MidiPlayer();\n",
       "                               mp.addPlayer('#midiPlayerDiv17713');\n",
       "                               mp.base64Load('data:audio/midi;base64,TVRoZAAAAAYAAQABBABNVHJrAAAEfgD/AwAA4ABAAP9ZAgAAAP9YBAQCGAiIAJA8WoQAgDwAAJBAWoQAgEAAAJA+WoQAgD4AAJBBWoQAgEEAAJBAWoQAgEAAAJBDWoQAgEMAAJBBWoQAgEEAAJBFWoQAgEUAAJBDWoQAgEMAAJBAWoQAgEAAAJBBWoQAgEEAAJA+WoQAgD4AAJA8WoQAgDwAAJBAWoQAgEAAAJA8WgD/WQL7AIgAgDwAAJA9WoQAgD0AAJBBWoQAgEEAAJA/WoQAgD8AAJBCWoQAgEIAAJBBWoQAgEEAAJBEWoQAgEQAAJBCWoQAgEIAAJBGWoQAgEYAAJBEWoQAgEQAAJBBWoQAgEEAAJBCWoQAgEIAAJA/WoQAgD8AAJA9WoQAgD0AAJBBWoQAgEEAAJA9WgD/WQICAIgAgD0AAJA+WoQAgD4AAJBCWoQAgEIAAJBAWoQAgEAAAJBDWoQAgEMAAJBCWoQAgEIAAJBFWoQAgEUAAJBDWoQAgEMAAJBHWoQAgEcAAJBFWoQAgEUAAJBCWoQAgEIAAJBDWoQAgEMAAJBAWoQAgEAAAJA+WoQAgD4AAJBCWoQAgEIAAJA+WgD/WQL9AIgAgD4AAJA/WoQAgD8AAJBDWoQAgEMAAJBBWoQAgEEAAJBEWoQAgEQAAJBDWoQAgEMAAJBGWoQAgEYAAJBEWoQAgEQAAJBIWoQAgEgAAJBGWoQAgEYAAJBDWoQAgEMAAJBEWoQAgEQAAJBBWoQAgEEAAJA/WoQAgD8AAJBDWoQAgEMAAJA/WgD/WQIEAIgAgD8AAJBAWoQAgEAAAJBEWoQAgEQAAJBCWoQAgEIAAJBFWoQAgEUAAJBEWoQAgEQAAJBHWoQAgEcAAJBFWoQAgEUAAJBJWoQAgEkAAJBHWoQAgEcAAJBEWoQAgEQAAJBFWoQAgEUAAJBCWoQAgEIAAJBAWoQAgEAAAJBEWoQAgEQAAJBAWgD/WQL/AIgAgEAAAJBBWoQAgEEAAJBFWoQAgEUAAJBDWoQAgEMAAJBGWoQAgEYAAJBFWoQAgEUAAJBIWoQAgEgAAJBGWoQAgEYAAJBKWoQAgEoAAJBIWoQAgEgAAJBFWoQAgEUAAJBGWoQAgEYAAJBDWoQAgEMAAJBBWoQAgEEAAJBFWoQAgEUAAJBBWgD/WQIGAIgAgEEAAJBCWoQAgEIAAJBGWoQAgEYAAJBEWoQAgEQAAJBHWoQAgEcAAJBGWoQAgEYAAJBJWoQAgEkAAJBHWoQAgEcAAJBLWoQAgEsAAJBJWoQAgEkAAJBGWoQAgEYAAJBHWoQAgEcAAJBEWoQAgEQAAJBCWoQAgEIAAJBGWoQAgEYAAJBCWgD/WQIBAIgAgEIAAJBDWoQAgEMAAJBHWoQAgEcAAJBFWoQAgEUAAJBIWoQAgEgAAJBHWoQAgEcAAJBKWoQAgEoAAJBIWoQAgEgAAJBMWoQAgEwAAJBKWoQAgEoAAJBHWoQAgEcAAJBIWoQAgEgAAJBFWoQAgEUAAJBDWoQAgEMAAJBHWoQAgEcAAJBDWogAgEMAiAD/LwA=');\n",
       "                        });\n",
       "                </script>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "out.show('midi')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "sphinx_links": {
     "any": true
    }
   },
   "source": [
    "That's enough about keys for now, let's move on to a fast way of getting small amounts of music into music21, with :ref:`Chapter 16, Tiny Notation <usersGuide_16_tinyNotation>`"
   ]
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "celltoolbar": "Tags",
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}
